| Current File : //usr/lib/python3/dist-packages/twisted/web/__pycache__/_newclient.cpython-312.pyc |
�
Ϫ�fN� � �� � d Z ddlZddlmZ ddlmZmZmZmZm Z ddl
m Z ddl m
Z
mZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lm Z ddl m Z m Z m Z m!Z!m"Z"m#Z# ddl$m%Z% ddl&m'Z'm(Z(m)Z) dZ*dZ+dZ,dZ- e� Z. G d� de/� Z0 G d� de/� Z1 G d� de/� Z2 G d� d e2� Z3 G d � d e/� Z4 G d � d e4� Z5 G d!� d"e4� Z6 G d#� d$e/� Z7 G d%� d&e/� Z8 G d'� d(e/� Z9 G d)� d*e4� Z: G d+� d,e:� Z; G d-� d.e/� Z<d/� Z= G d0� d1e� Z> G d2� d3e>� Z? ej� d4 eA� j� d5� fz � ZCd6� ZD ej� d7� ZEd8� ZF ee(� G d9� d:� � ZG G d;� d<� ZHd=� ZI ee(� ZJ ee)� G d>� d?� � ZK ee
� G d@� dA� � ZL ee� G dB� dC� � ZM G dD� dEe� ZNy)Fa�
An U{HTTP 1.1<http://www.w3.org/Protocols/rfc2616/rfc2616.html>} client.
The way to use the functionality provided by this module is to:
- Connect a L{HTTP11ClientProtocol} to an HTTP server
- Create a L{Request} with the appropriate data
- Pass the request to L{HTTP11ClientProtocol.request}
- The returned Deferred will fire with a L{Response} object
- Create a L{IProtocol} provider which can handle the response body
- Connect it to the response with L{Response.deliverBody}
- When the protocol's C{connectionLost} method is called, the response is
complete. See L{Response.deliverBody} for details.
Various other classes in this module support this usage:
- HTTPParser is the basic HTTP parser. It can handle the parts of HTTP which
are symmetric between requests and responses.
- HTTPClientParser extends HTTPParser to handle response-specific parts of
HTTP. One instance is created for each request to parse the corresponding
response.
� N)� implementer)�CancelledError�Deferred�fail�
maybeDeferred�succeed)�ConnectionDone)� IConsumer�
IPushProducer)�Protocol)�Logger)� LineReceiver)�
networkString)�proxyForInterface)�Failure)�fullyQualifiedName)�
NO_CONTENT� NOT_MODIFIED�PotentialDataLoss�_ChunkedTransferDecoder� _DataLoss�_IdentityTransferDecoder)�Headers)�UNKNOWN_LENGTH�IClientRequest� IResponse�STATUS�HEADER�BODY�DONEc � � e Zd ZdZy)�
BadHeadersz@
Headers passed to L{Request} were in some way invalid.
N��__name__�
__module__� __qualname__�__doc__� � �8/usr/lib/python3/dist-packages/twisted/web/_newclient.pyr" r" D � � �r) r" c � � e Zd ZdZy)� ExcessWritezx
The body L{IBodyProducer} for a request tried to write data after
indicating it had finished writing data.
Nr# r( r) r* r- r- J s � �r) r- c � � e Zd ZdZd� Zy)�
ParseErrorzh
Some received data could not be parsed.
@ivar data: The string which could not be parsed.
c �@ � t j | ||� || _ y �N)� Exception�__init__�data)�self�reasonr4 s r* r3 zParseError.__init__X s � ����4���.��� r) N�r$ r% r& r' r3 r( r) r* r/ r/ Q s � �� r) r/ c � � e Zd ZdZy)�BadResponseVersionz=
The version string in a status line was unparsable.
Nr# r( r) r* r9 r9 ] r+ r) r9 c � � e Zd ZdZd� Zy)�_WrapperExceptiona,
L{_WrapperException} is the base exception type for exceptions which
include one or more other exceptions as the low-level causes.
@ivar reasons: A L{list} of one or more L{Failure} instances encountered
during an HTTP request. See subclass documentation for more details.
c �> � t j | |� || _ y r1 )r2 r3 �reasons)r5 r= s r* r3 z_WrapperException.__init__l s � ����4��)� �� r) Nr7 r( r) r* r; r; c s � �� r) r; c � � e Zd ZdZy)�RequestGenerationFailedz�
There was an error while creating the bytes which make up a request.
@ivar reasons: A C{list} of one or more L{Failure} instances giving the
reasons the request generation was considered to have failed.
Nr# r( r) r* r? r? q � � �r) r? c � � e Zd ZdZy)�RequestTransmissionFailedz�
There was an error while sending the bytes which make up a request.
@ivar reasons: A C{list} of one or more L{Failure} instances giving the
reasons the request transmission was considered to have failed.
Nr# r( r) r* rB rB z r@ r) rB c � � e Zd ZdZy)�ConnectionAbortedzD
The connection was explicitly aborted by application code.
Nr# r( r) r* rD rD � r+ r) rD c � � e Zd ZdZy)�WrongBodyLengthz�
An L{IBodyProducer} declared the number of bytes it was going to
produce (via its C{length} attribute) and then produced a different number
of bytes.
Nr# r( r) r* rF rF � � � �r) rF c � � e Zd ZdZy)� ResponseDonez�
L{ResponseDone} may be passed to L{IProtocol.connectionLost} on the
protocol passed to L{Response.deliverBody} and indicates that the entire
response has been delivered.
Nr# r( r) r* rI rI � rG r) rI c � � e Zd ZdZdd�Zy)�ResponseFaileda�
L{ResponseFailed} indicates that all of the response to a request was not
received for some reason.
@ivar reasons: A C{list} of one or more L{Failure} instances giving the
reasons the response was considered to have failed.
@ivar response: If specified, the L{Response} received from the server (and
in particular the status code and the headers).
Nc �> � t j | |� || _ y r1 )r; r3 �response)r5 r= rM s r* r3 zResponseFailed.__init__� s � ��"�"�4��1� ��
r) r1 r7 r( r) r* rK rK � s � � �!r) rK c � � e Zd ZdZy)�ResponseNeverReceivedzU
A L{ResponseFailed} that knows no response bytes at all have been received.
Nr# r( r) r* rO rO � r+ r) rO c � � e Zd ZdZy)�RequestNotSentaF
L{RequestNotSent} indicates that an attempt was made to issue a request but
for reasons unrelated to the details of the request itself, the request
could not be sent. For example, this may indicate that an attempt was made
to send a request using a protocol which is no longer connected to a
server.
Nr# r( r) r* rQ rQ � s � �r) rQ c �r � | � y# t $ r# t j dt | � �� Y yw xY w)z�
Call C{function}. If it raises an exception, log it with a minimal
description of the source.
@return: L{None}
z Unexpected exception from {name})�nameN)�
BaseException�
_moduleLog�failurer )�functions r* �_callAppFunctionrX � s9 � �
��
�� �
���� .�5G��5Q� �
�
�s �
�)6�6c �L � e Zd ZdZdZh d�Zd� Zd� Zd� Zd� Z d� Z
d � Z d
� Z d � Z
y )
�
HTTPParsera
L{HTTPParser} handles the parsing side of HTTP processing. With a suitable
subclass, it can parse either the client side or the server side of the
connection.
@ivar headers: All of the non-connection control message headers yet
received.
@ivar state: State indicator for the response parsing state machine. One
of C{STATUS}, C{HEADER}, C{BODY}, C{DONE}.
@ivar _partialHeader: L{None} or a C{list} of the lines of a multiline
header while that header is being received.
�
> � te� upgrade� trailers�
keep-alive� proxy-connection�
connection� content-length� transfer-encodingc �d � t � | _ t � | _ t | _ d | _ y r1 )r �headers� connHeadersr �state�_partialHeader�r5 s r* �connectionMadezHTTPParser.connectionMade� s$ � � �y�� �"�9�����
� "��r) c � � | j t k( r t d� �|| _ t | _ | j � y)z�
Switch to body parsing mode - interpret any more bytes delivered as
part of the message body and deliver them to the given decoder.
zalready in body modeN)rg r � RuntimeError� bodyDecoder�
setRawMode)r5 �decoders r* �switchToBodyModezHTTPParser.switchToBodyMode s5 � �
�:�:�� � � 5�6� 6�"�����
� ���r) c �� � |dd dk( r|dd }| j t k( r | j |� t | _ y| j t k( r�|r|d dvrz| j �Rdj | j � }|j
dd� \ }}|j � }| j ||� |s| j � y|g| _ y| j j |� yy) z2
Handle one line from a response.
���N�
r s r) � :� ) rg r �statusReceivedr rh �join�split�strip�headerReceived�allHeadersReceived�append)r5 �line�headerrS �values r* � lineReceivedzHTTPParser.lineReceived
s� � �
���9�� ����9�D� �:�:�� � � � �� %� �D�J�
�Z�Z�6�
!��4��7�&�0��&�&�2� �X�X�d�&9�&9� :�F�"(�,�,�t�Q�"7�K�D�%� !�K�K�M�E��'�'��e�4���+�+�-� ,0�&�D�'� �#�#�*�*�4�0�! "r) c �: � | j j |� y)zM
Pass data from the message body to the body decoder object.
N)rm � dataReceived�r5 r4 s r* �rawDataReceivedzHTTPParser.rawDataReceived* s � �
���%�%�d�+r) c � � || j v S )a�
Return C{True} if the given lower-cased name is the name of a
connection control header (rather than an entity header).
According to RFC 2616, section 14.10, the tokens in the Connection
header are probably relevant here. However, I am not sure what the
practical consequences of either implementing or ignoring that are.
So I leave it unimplemented for the time being.
)�CONNECTION_CONTROL_HEADERS�r5 rS s r* �isConnectionControlHeaderz$HTTPParser.isConnectionControlHeader0 s � � �t�6�6�6�6r) c � � y)a
Callback invoked whenever the first line of a new message is received.
Override this.
@param status: The first line of an HTTP request or response message
without trailing I{CR LF}.
@type status: C{bytes}
Nr( )r5 �statuss r* rv zHTTPParser.statusReceived< � � r) c � � |j � }| j |� r
| j }n | j }|j ||� y)z<
Store the given header in C{self.headers}.
N)�lowerr� rf re � addRawHeader)r5 rS r re s r* rz zHTTPParser.headerReceivedF sA � � �z�z�|�� � )� )�$� /��&�&�G��l�l�G�� � �T�5�)r) c �& � | j d� y)z�
Callback invoked after the last header is passed to C{headerReceived}.
Override this to change to the C{BODY} or C{DONE} state.
N)rp ri s r* r{ z HTTPParser.allHeadersReceivedQ s � �
� � �d�#r) N)r$ r% r& r' � delimiterr� rj rp r� r� r� rv rz r{ r( r) r* rZ rZ � s? � �
�H �I� "� �#�
�1�:,�
7� � *�$r) rZ c �b � e Zd ZdZeehZdeiZdZ e
� Z d� Z d� Z
d� Zd� Zd� Zd � Zd
� Zd � Zy) �HTTPClientParseraL
An HTTP parser which only handles HTTP responses.
@ivar request: The request with which the expected response is associated.
@type request: L{Request}
@ivar NO_BODY_CODES: A C{set} of response codes which B{MUST NOT} have a
body.
@ivar finisher: A callable to invoke when this response is fully parsed.
@ivar _responseDeferred: A L{Deferred} which will be called back with the
response when all headers in the response have been received.
Thereafter, L{None}.
@ivar _everReceivedData: C{True} if any bytes have been received.
s chunkedNc �L � || _ || _ t � | _ d| _ y )NF)�request�finisherr �_responseDeferred�_everReceivedData)r5 r� r� s r* r3 zHTTPClientParser.__init__u s" � � �� � ��
�!)��� �!&�� r) c �> � d| _ t j | |� y)zM
Override so that we know if any response has been received.
TN)r� rZ r� r� s r* r� z HTTPClientParser.dataReceived{ s � � "&�� �� � ��d�+r) c � � |j d� \ }}|j d� \ }}t |� t |� }}|dk s|dk r t d|� �|||fS # t $ r}t t |� |� �d}~ww xY w)z�
Parse version strings of the form Protocol '/' Major '.' Minor. E.g.
b'HTTP/1.1'. Returns (protocol, major, minor). Will raise ValueError
on bad syntax.
� /� .Nr zversion may not be negative)rx �int�
ValueErrorr9 �str)r5 �
strversion�proto� strnumber�major�minor�es r* � parseVersionz HTTPClientParser.parseVersion� s� � � 9� )� /� /�� 5� �E�9�$�?�?�4�0�L�E�5� �u�:�s�5�z�5�E� �1�9��� �$�%B�J�O� O��u�e�$�$�� � 9�$�S��V�Z�8� 8�� 9�s �>A � A>�$A9�9A>c �x � |j dd� }t |� dk( r|\ }}d}n!t |� dk( r|\ }}}n t d|� � t |� }t
j
| j |� ||| j | j | j � | _ y# t $ r
t d|� �w xY w)z�
Parse the status line into its components and create a response object
to keep track of this response's state.
� � r) � zwrong number of partsznon-integer status codeN) rx �lenr/ r� r� �Response�
_constructr� re � transportr� rM )r5 r� �parts�version� codeBytes�phrase�
statusCodes r* rv z HTTPClientParser.statusReceived� s� � �
� � �T�1�%�� �u�:��?�
"'� �G�Y��F�
��Z�1�_�).� &�G�Y�� � 4�f�=� =� @� �Y� �J� !�+�+� � � �g� &� � � �L�L� �N�N� �L�L�
��
�� � @� � 6��?� ?� @�s � B# �#B9c �< � t | _ | j |� y)a�
Called to indicate that an entire response has been received. No more
bytes will be interpreted by this L{HTTPClientParser}. Extra bytes are
passed up and the state of this L{HTTPClientParser} is set to I{DONE}.
@param rest: A C{bytes} giving any extra bytes delivered to this
L{HTTPClientParser} which are not part of the response being
parsed.
N)r rg r� �r5 �rests r* � _finishedzHTTPClientParser._finished� s � � ��
� �
�
�d�r) c �l � | j j dk( r|dk( ryt j | |� S )z�
Content-Length in the response to a HEAD request is an entity header,
not a connection control header.
� HEADrb F)r� �methodrZ r� r� s r* r� z*HTTPClientParser.isConnectionControlHeader� s4 � �
�<�<� � �'� )�d�6G�.G���3�3�D�$�?�?r) c � �� d| j j cxk rdk rGn nD| j j d| j j �� | j � | ` y| j j | j
v s| j j dk( rLd| j _ | j | j � � | j j � �n0| j j d� }|r!| j |d j � }n�| j j d � }|�d�n9t! |� d
k( r t# |d � ��| j _ n t% d � ��dk( r"| j | j � � d}n�fd �}|�| j j � nP| j& j) � | j+ || j j, | j � � | j. j1 | j � | `y)
zn
Figure out how long the response body is going to be by examining
headers and stuff.
�d �� z#Ignoring unexpected {code} response)�codeNr� r rc rb ru z4Too many Content-Length headers; response is invalidc � �� t �| |� S r1 )r )�x�y�
contentLengths �r* �<lambda>z5HTTPClientParser.allHeadersReceived.<locals>.<lambda> s �� �3K�%�q�!�4� r) )rM r� �_log�inforj �
NO_BODY_CODESr� r� �lengthr� �clearLineBuffer�_bodyDataFinishedrf �
getRawHeaders�_transferDecodersr� r� r� r� r� �pauseProducingrp �_bodyDataReceivedr� �callback)r5 �transferEncodingHeaders�transferDecoder�contentLengthHeadersr� s @r* r{ z#HTTPClientParser.allHeadersReceived� s� �� �
�$�-�-�$�$� *�s� *�
�I�I�N�N�5�D�M�M�<N�<N�
�
�
� � � !��
� � �=�=� � ��!3�!3� 3�t�|�|�7J�7J�g�7U�#$�D�M�M� �
�N�N�4�/�/�1� 2� �M�M� +� +� -�&*�&6�&6�&D�&D�$�'� #� '� #'�"8�"8�+�A�.�4�4�6�#�� (,�'7�'7�'E�'E�FW�'X�$�'�/�$(�M��-�.�!�3�$'�(<�Q�(?�$@�M�+8�D�M�M�(� %�Q�� � !�A�%��N�N�4�#7�#7�#9�:�&*�O�'�O� �&��
�
�/�/�1� ���-�-�/��%�%�#�D�M�M�$C�$C�T�^�^�T��
� � �'�'��
�
�6� � "r) c
� � | j �9 | j j � | j j � y y y | j t k7 rG| j rt }nt }| j j! t ||g� � � | `y y # t $ r& | j j t � � Y ��t $ rE | j j t t |t � g| j � � � Y ��w xY w# t $ r | j j d� Y y w xY w)N� )rm �
noMoreDatarM r� r r r rK rT r� rV rg r r� rO r� �errback)r5 r6 �exceptionClasss r* �connectionLostz HTTPClientParser.connectionLost s � � � � � '�
&� 6��$�$�/�/�1� �M�M�3�3�5� � ?� �Z�Z�4�
��%�%�!/��!6�� � "� "� *� *�7�>�6�(�3K�+L� M��&�
�� )� ?��M�M�3�3�G�I�>� � ��M�M�3�3� ���� �/B�D�M�M� R�S���� !�
&�
� � �!�!�"�%�
&�s; �B! �D �!,D �
D �A
D �D �D � D � $E�E)r$ r% r& r' r r r� r r� rm r
r� r3 r� r� rv r� r� r{ r� r( r) r* r� r� Y s] � ��$ � �.�M� �+��� �K� �8�D�'� ,�%�
�@ �@�T#�l'r) r� s \A[%s]+\Z)� !� #� $� %� &� '� *� +� -r� � ^� _� `� |� ~s 0-9s A-Zs a-zc �L � t j | � r| S t d| ��� �)a
An HTTP method is an HTTP token, which consists of any visible
ASCII character that is not a delimiter (i.e. one of
C{"(),/:;<=>?@[\]{}}.)
@param method: the method to check
@type method: L{bytes}
@return: the method if it is valid
@rtype: L{bytes}
@raise ValueError: if the method is not valid
@see: U{https://tools.ietf.org/html/rfc7230#section-3.1.1},
U{https://tools.ietf.org/html/rfc7230#section-3.2.6},
U{https://tools.ietf.org/html/rfc5234#appendix-B.1}
zInvalid method )�
_VALID_METHOD�matchr� )r� s r* �_ensureValidMethodr� W s) � �$ ���6�"��
�
��v�j�1�
2�2r) s \A[\x21-\x7e]+\Zc �L � t j | � r| S t d| ��� �)a
A valid URI cannot contain control characters (i.e., characters
between 0-32, inclusive and 127) or non-ASCII characters (i.e.,
characters with values between 128-255, inclusive).
@param uri: the URI to check
@type uri: L{bytes}
@return: the URI if it is valid
@rtype: L{bytes}
@raise ValueError: if the URI is not valid
@see: U{https://tools.ietf.org/html/rfc3986#section-3.3},
U{https://tools.ietf.org/html/rfc3986#appendix-A},
U{https://tools.ietf.org/html/rfc5234#appendix-B.1}
z Invalid URI )�
_VALID_URIr� r� )�uris r* �_ensureValidURIr� q s) � �$ ���� ��
�
�|�C�7�+�
,�,r) c �n � e Zd ZdZ e� Zd d�Ze d
d�� Ze d� � Z
d� Z d� Z d� Z
d � Zd
� Zd � Zy)�Requesta�
A L{Request} instance describes an HTTP request to be sent to an HTTP
server.
@ivar method: See L{__init__}.
@ivar uri: See L{__init__}.
@ivar headers: See L{__init__}.
@ivar bodyProducer: See L{__init__}.
@ivar persistent: See L{__init__}.
@ivar _parsedURI: Parsed I{URI} for the request, or L{None}.
@type _parsedURI: L{twisted.web.client.URI} or L{None}
c �| � t |� | _ t |� | _ || _ || _ || _ d| _ y)at
@param method: The HTTP method for this request, ex: b'GET', b'HEAD',
b'POST', etc.
@type method: L{bytes}
@param uri: The relative URI of the resource to request. For example,
C{b'/foo/bar?baz=quux'}.
@type uri: L{bytes}
@param headers: Headers to be sent to the server. It is important to
note that this object does not create any implicit headers. So it
is up to the HTTP Client to add required headers such as 'Host'.
@type headers: L{twisted.web.http_headers.Headers}
@param bodyProducer: L{None} or an L{IBodyProducer} provider which
produces the content body to send to the remote HTTP server.
@param persistent: Set to C{True} when you use HTTP persistent
connection, defaults to C{False}.
@type persistent: L{bool}
N)r� r� r� r� re � bodyProducer�
persistent�
_parsedURI)r5 r� r� re r� r� s r* r3 zRequest.__init__� s9 � �, )��0�� �"�3�'��� �� � (���$��� ��r) Nc �, � | |||||� }||_ |S )aS
Private constructor.
@param method: See L{__init__}.
@param uri: See L{__init__}.
@param headers: See L{__init__}.
@param bodyProducer: See L{__init__}.
@param persistent: See L{__init__}.
@param parsedURI: See L{Request._parsedURI}.
@return: L{Request} instance.
)r� )�clsr� r� re r� r� � parsedURIr� s r* r� zRequest._construct� s# � � �f�c�7�L�*�E�� &����r) c �< � t | j dd� � � S )z{
The absolute URI of the request as C{bytes}, or L{None} if the
absolute URI cannot be determined.
�toBytesc � � y r1 r( r( r) r* r� z%Request.absoluteURI.<locals>.<lambda>� r� r) )�getattrr� ri s r* � absoluteURIzRequest.absoluteURI� s � � A�w�t��� �<�@�B�Br) c �F � | j j dd� }t |� dk7 r t d� �g }|j dj t
| j � t | j � dg� � | j s|j d� |�|j |� | j j � D ]- \ }}|j |D �cg c]
}|dz |z d z �� c}� �/ |j d � |j |� y c c}w )
Ns hostr( ru z Exactly one Host header requiredr� s
HTTP/1.1
s Connection: close
s : �
)re r� r� r" r| rw r� r� r� r� r� �getAllRawHeaders�extend�
writeSequence)r5 r� �TEorCL�hosts� requestLinesrS �values�vs r* �
_writeHeaderszRequest._writeHeaders� s � �� � �*�*�7�B�7�� �u�:��?� � ?�@� @�
� ���� �I�I�&�t�{�{�3�#�D�H�H�-�#��
�
� ��� � � � 8� 9� � � � � �� '� �L�L� 9� 9� ;� N�L�D�&� � � �V� L���� ��!1�G�!;� L� M� N����G�$�� � � �-�� !Ms � D
c �� ��� | j �d� t �� ��j | j d� | j j �� }�fd�}��fd�}|j ||� |S )z�
Write this request to the given transport using chunked
transfer-encoding to frame the body.
@param transport: See L{writeTo}.
@return: See L{writeTo}.
s Transfer-Encoding: chunked
Tc �& �� �j � y r1 ��unregisterProducer)�ignored�encoders �r* �
cbProducedz7Request._writeToBodyProducerChunked.<locals>.cbProduced� s �� � � &� &� (r) c �H �� �j � �j � | S r1 )�_allowNoMoreWritesr )�errr r� s ��r* �
ebProducedz7Request._writeToBodyProducerChunked.<locals>.ebProduced� s" �� � � &� &� (�
� (� (� *��Jr) )r �ChunkedEncoder�registerProducerr� �startProducing� addCallbacks)r5 r� �dr r r s ` @r* �_writeToBodyProducerChunkedz#Request._writeToBodyProducerChunked� sk �� �
���9�&G�H� ��+��� � ��!2�!2�D�9� � � � ,� ,�W� 5�� )� �
���z�:�.��r) c �p � ���� � j �t d� j j fz � � t � }t � j �|� ��j
� j d� � j j �� ���� fd�} ||�� }�fd�}|j |� |S )z�
Write this request to the given transport using content-length to frame
the body.
@param transport: See L{writeTo}.
@return: See L{writeTo}.
zContent-Length: %d
Tc � ���� � fd�}t |� �d g��
��fd�}���fd�}��
��fd�}| j |� |j ||� �S )Nc �& �� �j � y r1 )�cancel)�ign�finishedProducings �r* �cancelConsumingzSRequest._writeToBodyProducerContentLength.<locals>.combine.<locals>.cancelConsuming+ s �� �!�(�(�*r) c � �� �d gk( rd�d< �j | � y �j j d| t �� �d �� y )Nru r z>Buggy state machine in {request}/[{state}]: ebConsuming called)rV r� rg )r� r� rV �repr)r r5 rg �ultimates ���r* � ebConsumingzORequest._writeToBodyProducerContentLength.<locals>.combine.<locals>.ebConsuming6 sT �� ��T�F�?� !�E�!�H� �$�$�S�)� �I�I�%�%�-� #� $�T�
� #�A�h� &� r) c � �� �d gk( r(d�d< �j � �j d � y y # t $ r �j � Y y w xY w)Nr� r )�_noMoreWritesExpectedr� rT r� )�resultr rg r s ���r* � cbProducingzORequest._writeToBodyProducerContentLength.<locals>.combine.<locals>.cbProducingM s\ �� ��T�F�?�
!�E�!�H�0� �5�5�7� !�)�)�$�/� #�� )� +� !�(�(�*�+�s �1 �A
� A
c � �� �d gk( r'd�d< �j � �j | � y �j j d| �� y )Nr� r zProducer is buggy)rV )r r� r� rV )r r r5 rg r s ����r* � ebProducingzORequest._writeToBodyProducerContentLength.<locals>.combine.<locals>.ebProducingb sK �� ��T�F�?� !�E�!�H��.�.�0� �$�$�S�)� �I�I�%�%�&9�3�%�Gr) )r �
addErrbackr ) � consuming� producingr r! r% r' rg r r r r5 s @@���r* �combinez:Request._writeToBodyProducerContentLength.<locals>.combine' sR �� �
+� ��0�H� �F�E�
�.
0�*
H�"
� � �� -� � "� "�;� � <��Or) c �( �� �j � | S r1 r )� passthroughr� s �r* �fz4Request._writeToBodyProducerContentLength.<locals>.fz s �� �
� (� (� *� � r) ) r r r� r� r �LengthEnforcingConsumerr r �addBoth)r5 r� �finishedConsumingr+ r r. r r s `` @@r* �!_writeToBodyProducerContentLengthz)Request._writeToBodyProducerContentLength
s� �� �
��� � �2�d�6G�6G�6N�6N�5P�P� Q�
� %�J�� *� � � �y�*;�
�� �"�"�4�#4�#4�d�;� � -� -� <� <�W� E��O �b
�%�'8� 9�� �
� � �!� ��r) c �< � | j |d� t d� S )z�
Write this request to the given transport using content-length to frame
the (empty) body.
@param transport: See L{writeTo}.
@return: See L{writeTo}.
s Content-Length: 0
N)r r �r5 r� s r* � _writeToEmptyBodyContentLengthz&Request._writeToEmptyBodyContentLength� s � �
���9�&>�?��t�}� r) c � � | j �3| j dv r| j |� y| j |d� y| j j t
u r| j
|� S | j |� S )a
Format this L{Request} as an HTTP/1.1 request and write it to the given
transport. If bodyProducer is not None, it will be associated with an
L{IConsumer}.
@param transport: The transport to which to write.
@type transport: L{twisted.internet.interfaces.ITransport} provider
@return: A L{Deferred} which fires with L{None} when the request has
been completely written to the transport or with a L{Failure} if
there is any problem generating the request bytes.
N)s PUTs POST)r� r� r5 r r� r r r2 r4 s r* �writeTozRequest.writeTo� ss � � � � � $� �{�{� /�/��3�3�I�>��"�"�9�d�3�
�
�
�
%�
%� �
7��3�3�I�>� >��9�9�)�D� Dr) c �B � t | j j � y)aR
Stop writing this request to the transport. This can only be called
after C{writeTo} and before the L{Deferred} returned by C{writeTo}
fires. It should cancel any asynchronous task started by C{writeTo}.
The L{Deferred} returned by C{writeTo} need not be fired if this method
is called.
N)rX r� �
stopProducingri s r* � stopWritingzRequest.stopWriting� s � � ��*�*�8�8�9r) )F)FN)r$ r% r& r' r
r� r3 � classmethodr� �propertyr� r r r2 r5 r7 r: r( r) r* r� r� � sc � � � �8�D� �: �MQ�� ��& �C� �C�.�6�8x�t �E�4
:r) r� c �( � e Zd ZdZd� Zd� Zd� Zd� Zy)r/ a�
An L{IConsumer} proxy which enforces an exact length requirement on the
total data written to it.
@ivar _length: The number of bytes remaining to be written.
@ivar _producer: The L{IBodyProducer} which is writing to this
consumer.
@ivar _consumer: The consumer to which at most C{_length} bytes will be
forwarded.
@ivar _finished: A L{Deferred} which will be fired with a L{Failure} if too
many bytes are written to this consumer.
c �P � |j | _ || _ || _ || _ y r1 )r� �_length� _producer� _consumerr� )r5 �producer�consumer�finisheds r* r3 z LengthEnforcingConsumer.__init__� s" � � ���� �!���!���!��r) c � � d| _ y�z�
Indicate that no additional writes are allowed. Attempts to write
after calling this method will be met with an exception.
N)r� ri s r* r z*LengthEnforcingConsumer._allowNoMoreWrites� � � �
��r) c � � | j �$| j j � t � �t |� | j
k r:| xj
t |� z c_ | j j |� yt | j j � | j j t d� � | j � y)z�
Write C{bytes} to the underlying consumer unless
C{_noMoreWritesExpected} has been called or there are/have been too
many bytes.
Nztoo many bytes written) r� r@ r9 r- r� r? rA �writerX r� rF r �r5 �bytess r* rI z LengthEnforcingConsumer.write� s� � � �>�>� !�
�N�N� (� (� *� �-� � �u�:�� � � %� �L�L�C��J� &�L� �N�N� � �� '�
�T�^�^� 9� 9� :� �N�N� "� "�?�3K�#L� M� � #� #� %r) c �l � | j �(| j � | j r t d� �yy)z�
Called to indicate no more bytes will be written to this consumer.
Check to see that the correct number have been written.
@raise WrongBodyLength: If not enough bytes have been written.
Nztoo few bytes written)r� r r? rF ri s r* r# z-LengthEnforcingConsumer._noMoreWritesExpected� s7 � � �>�>� %� � #� #� %��|�|�%�&=�>�>� � &r) N)r$ r% r& r' r3 r rI r# r( r) r* r/ r/ � s � �� "� �&�8
?r) r/ c �4 � � � fd�}|j |_ |S )a}
Given a I{dispatch} name and a function, return a function which can be
used as a method and which, when called, will call another method defined
on the instance and return the result. The other method which is called is
determined by the value of the C{_state} attribute of the instance.
@param name: A string which is used to construct the name of the subsidiary
method to invoke. The subsidiary method is named like C{'_%s_%s' %
(name, _state)}.
@param template: A function object which is used to give the returned
function a docstring.
@return: The dispatcher function.
c � �� t | d�z dz | j z d � }|� t | �d�� d| j � �� � ||i |��S )N�_z has no z method in state )r� �_staterl )r5 �args�kwargs�funcrS s �r* �
dispatcherz*makeStatefulDispatcher.<locals>.dispatcher sY �� ��t�S�4�Z�#� -�� � � ;�T�B�� �<� �$���$��7H����
� V�W� W��T�$�V�$�$r) )r' )rS �templaterT s ` r* �makeStatefulDispatcherrV � s �� �"%� "�)�)�J�� �r) c �� � e Zd ZdZeZdZdZd� Ze d� � Z
d� Z d� Z e
de � Z d � Zd
� Zd � Zd � Zd
� Z e
de� Zd� Zd� Zd� Zd� Zdd�Z e
de� Zdd�Zdd�Zd� Zd� Zy)r� a
A L{Response} instance describes an HTTP response received from an HTTP
server.
L{Response} should not be subclassed or instantiated.
@ivar _transport: See L{__init__}.
@ivar _bodyProtocol: The L{IProtocol} provider to which the body is
delivered. L{None} before one has been registered with
C{deliverBody}.
@ivar _bodyBuffer: A C{list} of the strings passed to C{bodyDataReceived}
before C{deliverBody} is called. L{None} afterwards.
@ivar _state: Indicates what state this L{Response} instance is in,
particularly with respect to delivering bytes from the response body
to an application-supplied protocol object. This may be one of
C{'INITIAL'}, C{'CONNECTED'}, C{'DEFERRED_CLOSE'}, or C{'FINISHED'},
with the following meanings:
- INITIAL: This is the state L{Response} objects start in. No
protocol has yet been provided and the underlying transport may
still have bytes to deliver to it.
- DEFERRED_CLOSE: If the underlying transport indicates all bytes
have been delivered but no application-provided protocol is yet
available, the L{Response} moves to this state. Data is
buffered and waiting for a protocol to be delivered to.
- CONNECTED: If a protocol is provided when the state is INITIAL,
the L{Response} moves to this state. Any buffered data is
delivered and any data which arrives from the transport
subsequently is given directly to the protocol.
- FINISHED: If a protocol is provided in the DEFERRED_CLOSE state,
the L{Response} moves to this state after delivering all
buffered data to the protocol. Otherwise, if the L{Response} is
in the CONNECTED state, if the transport indicates there is no
more data, the L{Response} moves to this state. Nothing else
can happen once the L{Response} is in this state.
@type _state: C{str}
NFc � � || _ || _ || _ || _ || _ g | _ d| _ d| _ d| _ y)a�
@param version: HTTP version components protocol, major, minor. E.g.
C{(b'HTTP', 1, 1)} to mean C{b'HTTP/1.1'}.
@param code: HTTP status code.
@type code: L{int}
@param phrase: HTTP reason phrase, intended to give a short description
of the HTTP status code.
@param headers: HTTP response headers.
@type headers: L{twisted.web.http_headers.Headers}
@param _transport: The transport which is delivering this response.
�INITIALN) r� r� r� re �
_transport� _bodyBufferrP r� �previousResponse)r5 r� r� r� re rZ s r* r3 zResponse.__init__R sE � � �� ��� � �� � �� �$��� ��� �� ��� � $�� r) c �D � t |||||� }t |� |_ |S )aM
Private constructor.
@param version: See L{__init__}.
@param code: See L{__init__}.
@param phrase: See L{__init__}.
@param headers: See L{__init__}.
@param _transport: See L{__init__}.
@param request: See L{IResponse.request}.
@return: L{Response} instance.
)r� �_ClientRequestProxyr� )r� r� r� r� re rZ r� rM s r* r� zResponse._constructl s( � � �G�T�6�7�J�G��.�w�7����r) c � � || _ y r1 )r\ )r5 r\ s r* �setPreviousResponsez Response.setPreviousResponse~ s
� � 0�� r) c � � y)zi
Dispatch the given L{IProtocol} depending of the current state of the
response.
Nr( �r5 �protocols r* � deliverBodyzResponse.deliverBody� r� r) rd c �� � |j | j � || _ | j D ] }| j j |� � d| _ d| _ | j j
� y)z�
Deliver any buffered data to C{protocol} and prepare to deliver any
future data to it. Move to the C{'CONNECTED'} state.
N� CONNECTED)�makeConnectionrZ �
_bodyProtocolr[ r� rP �resumeProducing�r5 rc r4 s r* �_deliverBody_INITIALz Response._deliverBody_INITIAL� sh � �
� � ����0� %����$�$� 2�D� � � � +� +�D� 1� 2� ���!�� �
���'�'�)r) c �4 � t d| j �d�� �)z�
It is invalid to attempt to deliver data to a protocol when it is
already being delivered to another protocol.
z Response already has protocol z, cannot deliverBody again)rl rh rb s r* �_deliverBody_CONNECTEDz Response._deliverBody_CONNECTED� s � �
��)�)�
,�
�
r) c �� � |j | j � | j D ] }|j |� � d| _ |j | j
� d| _ y)z�
Deliver any buffered data to C{protocol} and then disconnect the
protocol. Move to the C{'FINISHED'} state.
N�FINISHED)rg rZ r[ r� r� �_reasonrP rj s r* �_deliverBody_DEFERRED_CLOSEz$Response._deliverBody_DEFERRED_CLOSE� sZ � � � � ����0��$�$� (�D� � !� !�$� '� (� ���� � �� � �-� �� r) c � � t d� �)z�
It is invalid to attempt to deliver data to a protocol after the
response body has been delivered to another protocol.
z2Response already finished, cannot deliverBody now.�rl rb s r* �_deliverBody_FINISHEDz Response._deliverBody_FINISHED� s � �
�O�P�Pr) c � � y)z�
Called by HTTPClientParser with chunks of data from the response body.
They will be buffered or delivered to the protocol passed to
deliverBody.
Nr( r� s r* r� zResponse._bodyDataReceived� r� r) �bodyDataReceivedc �: � | j j |� y)a
Buffer any data received for later delivery to a protocol passed to
C{deliverBody}.
Little or no data should be buffered by this method, since the
transport has been paused and will not be resumed until a protocol
is supplied.
N)r[ r| r� s r* �_bodyDataReceived_INITIALz"Response._bodyDataReceived_INITIAL� s � �
��� � ��%r) c �: � | j j |� y)zk
Deliver any data received to the protocol to which this L{Response}
is connected.
N)rh r� r� s r* �_bodyDataReceived_CONNECTEDz$Response._bodyDataReceived_CONNECTED� s � �
���'�'��-r) c � � t d� �)z�
It is invalid for data to be delivered after it has been indicated
that the response body has been completely delivered.
z0Cannot receive body data after _bodyDataFinishedrs r� s r* � _bodyDataReceived_DEFERRED_CLOSEz)Response._bodyDataReceived_DEFERRED_CLOSE� s � �
�M�N�Nr) c � � t d� �)zz
It is invalid for data to be delivered after the response body has
been delivered to a protocol.
z4Cannot receive body data after protocol disconnectedrs r� s r* �_bodyDataReceived_FINISHEDz#Response._bodyDataReceived_FINISHED� s � �
�T�U�Ur) c � � y)z�
Called by HTTPClientParser when no more body data is available. If the
optional reason is supplied, this indicates a problem or potential
problem receiving all of the response body.
Nr( �r5 r6 s r* r� zResponse._bodyDataFinished� r� r) �bodyDataFinishedc �L � d| _ |�t t d� � }|| _ y)z}
Move to the C{'DEFERRED_CLOSE'} state to wait for a protocol to
which to deliver the response body.
�DEFERRED_CLOSEN� Response body fully received)rP r rI rp r� s r* �_bodyDataFinished_INITIALz"Response._bodyDataFinished_INITIAL� s' � �
'�� � �>� �\�*H� I�J�F� �� r) c � � |�t t d� � }| j j |� d| _ d| _ y)zN
Disconnect the protocol and move to the C{'FINISHED'} state.
Nr� ro )r rI rh r� rP r� s r* �_bodyDataFinished_CONNECTEDz$Response._bodyDataFinished_CONNECTED� s< � � �>� �\�*H� I�J�F� ���)�)�&�1� !��� �� r) c � � t d� �)��
It is invalid to attempt to notify the L{Response} of the end of the
response body data more than once.
z&Cannot finish body data more than oncers ri s r* � _bodyDataFinished_DEFERRED_CLOSEz)Response._bodyDataFinished_DEFERRED_CLOSE s � �
�C�D�Dr) c � � t d� �)r� z3Cannot finish body data after protocol disconnectedrs ri s r* �_bodyDataFinished_FINISHEDz#Response._bodyDataFinished_FINISHED
s � �
�S�T�Tr) r1 ) r$ r% r& r' r r� rh �
_bodyFinishedr3 r; r� r` rd rV rk rm rq rt r� rx rz r| r~ r� r� r� r� r� r( r) r* r� r� s� � �*�X �F��M��M�%�4 �� ��"1� � )� � �D�K�*�(
�!�$Q� � /�/A�CT�U�� &�.�O�V� � /�/A�CT�U�� �!�E�Ur) r� c �. � e Zd ZdZd� Zd� Zd� Zd� Zd� Zy)r z�
Helper object which exposes L{IConsumer} on top of L{HTTP11ClientProtocol}
for streaming request bodies to the server.
c � � || _ y r1 �r� r4 s r* r3 zChunkedEncoder.__init__ s � �"��r) c � � d| _ yrF r� ri s r* r z!ChunkedEncoder._allowNoMoreWrites rG r) c �< � | j j ||� y)zE
Register the given producer with C{self.transport}.
N)r� r )r5 rB � streamings r* r z ChunkedEncoder.registerProducer& s � �
���'�'��)�<r) c � � | j �
t � �| j j t dt |� z � |df� y)z�
Write the given request body bytes to the transport using chunked
encoding.
@type data: C{bytes}
Nz%x
r� )r� r- r� r r� r� s r* rI zChunkedEncoder.write, s@ � � �>�>� !� �-� � ���$�$�
�8�c�$�i�/�
0�$�� @�
r) c �z � | j d� | j j � | j � y)zT
Indicate that the request body is complete and finish the request.
r) N)rI r� r r ri s r* r z!ChunkedEncoder.unregisterProducer9 s+ � �
�
�
�3�� ���)�)�+� � � �!r) N) r$ r% r& r' r3 r r rI r r( r) r* r r s � ��
#� �=�
�"r) r c �8 � e Zd ZdZdZd� Zd� Zd� Zd� Zd� Z d� Z
y )
�TransportProxyProducera'
An L{twisted.internet.interfaces.IPushProducer} implementation which
wraps another such thing and proxies calls to it until it is told to stop.
@ivar _producer: The wrapped L{twisted.internet.interfaces.IPushProducer}
provider or L{None} after this proxy has been stopped.
Fc � � || _ y r1 �r@ )r5 rB s r* r3 z TransportProxyProducer.__init__T s � �!��r) c � � d| _ y)z�
Stop forwarding calls of L{twisted.internet.interfaces.IPushProducer}
methods to the underlying L{twisted.internet.interfaces.IPushProducer}
provider.
Nr� ri s r* � stopProxyingz#TransportProxyProducer.stopProxyingW s � � ��r) c �R � | j �| j j � yy)zl
Proxy the stoppage to the underlying producer, unless this proxy has
been stopped.
N)r@ r9 ri s r* r9 z$TransportProxyProducer.stopProducing_ s# � �
�>�>� %� �N�N� (� (� *� &r) c �R � | j �| j j � yy)zn
Proxy the resumption to the underlying producer, unless this proxy has
been stopped.
N)r@ ri ri s r* ri z&TransportProxyProducer.resumeProducingg s# � �
�>�>� %� �N�N� *� *� ,� &r) c �R � | j �| j j � yy)zi
Proxy the pause to the underlying producer, unless this proxy has been
stopped.
N)r@ r� ri s r* r� z%TransportProxyProducer.pauseProducingo �# � �
�>�>� %� �N�N� )� )� +� &r) c �R � | j �| j j � yy)z�
Proxy the request to lose the connection to the underlying producer,
unless this proxy has been stopped.
N)r@ �loseConnectionri s r* r� z%TransportProxyProducer.loseConnectionw r� r) N) r$ r% r& r' �
disconnectingr3 r� r9 ri r� r� r( r) r* r� r� B s, � �� �M�"� �+�-�,�,r) r� c �� � e Zd ZdZdZdZdZdZdZdZ e
� Z d� fd�Z e
d� � Zd� Zd� Z ed e� Zd
� ZeZd � Zd � Zd
� Zd� Z ede� Zd� Zd� Zd� Zd� Zd� Z d� Z d� Z y)�HTTP11ClientProtocola(
L{HTTP11ClientProtocol} is an implementation of the HTTP 1.1 client
protocol. It supports as few features as possible.
@ivar _parser: After a request is issued, the L{HTTPClientParser} to
which received data making up the response to that request is
delivered.
@ivar _finishedRequest: After a request is issued, the L{Deferred} which
will fire when a L{Response} object corresponding to that request is
available. This allows L{HTTP11ClientProtocol} to fail the request
if there is a connection or parsing problem.
@ivar _currentRequest: After a request is issued, the L{Request}
instance used to make that request. This allows
L{HTTP11ClientProtocol} to stop request generation if necessary (for
example, if the connection is lost).
@ivar _transportProxy: After a request is issued, the
L{TransportProxyProducer} to which C{_parser} is connected. This
allows C{_parser} to pause and resume the transport in a way which
L{HTTP11ClientProtocol} can exert some control over.
@ivar _responseDeferred: After a request is issued, the L{Deferred} from
C{_parser} which will fire with a L{Response} when one has been
received. This is eventually chained with C{_finishedRequest}, but
only in certain cases to avoid double firing that Deferred.
@ivar _state: Indicates what state this L{HTTP11ClientProtocol} instance
is in with respect to transmission of a request and reception of a
response. This may be one of the following strings:
- QUIESCENT: This is the state L{HTTP11ClientProtocol} instances
start in. Nothing is happening: no request is being sent and no
response is being received or expected.
- TRANSMITTING: When a request is made (via L{request}), the
instance moves to this state. L{Request.writeTo} has been used
to start to send a request but it has not yet finished.
- TRANSMITTING_AFTER_RECEIVING_RESPONSE: The server has returned a
complete response but the request has not yet been fully sent
yet. The instance will remain in this state until the request
is fully sent.
- GENERATION_FAILED: There was an error while the request. The
request was not fully sent to the network.
- WAITING: The request was fully sent to the network. The
instance is now waiting for the response to be fully received.
- ABORTING: Application code has requested that the HTTP connection
be aborted.
- CONNECTION_LOST: The connection has been lost.
@type _state: C{str}
@ivar _abortDeferreds: A list of C{Deferred} instances that will fire when
the connection is lost.
� QUIESCENTNc � � y r1 r( )�cs r* r� z HTTP11ClientProtocol.<lambda>� r� r) c � � || _ g | _ y r1 )�_quiescentCallback�_abortDeferreds)r5 �quiescentCallbacks r* r3 z HTTP11ClientProtocol.__init__� s � �"3�� � !�� r) c � � | j S r1 �rP ri s r* rg zHTTP11ClientProtocol.state� s � ��{�{�r) c � � �� � j dk7 rt t � � S d� _ t |j � j
� ��� fd�}t
|� � _ |� _ t � j
� � _
t |� j � � _
� j j � j � � j j � _ � fd�}� fd�}�j! ||� � j S )a�
Issue C{request} over C{self.transport} and return a L{Deferred} which
will fire with a L{Response} instance or an error.
@param request: The object defining the parameters of the request to
issue.
@type request: L{Request}
@rtype: L{Deferred}
@return: The deferred may errback with L{RequestGenerationFailed} if
the request was not fully written to the transport due to a local
error. It may errback with L{RequestTransmissionFailed} if it was
not fully written to the transport due to a network error. It may
errback with L{ResponseFailed} if the request was sent (not
necessarily received) but some or all of the response was lost. It
may errback with L{RequestNotSent} if it is not possible to send
any more requests using this L{HTTP11ClientProtocol}.
r� � TRANSMITTINGc � �� �j dv r�j � y �j j � �j t t
� � � y )N)r� �%TRANSMITTING_AFTER_RECEIVING_RESPONSE)rP r r� �abortConnection�_disconnectParserr r )r �_requestDeferredr5 s ��r* �
cancelRequestz3HTTP11ClientProtocol.request.<locals>.cancelRequest� sD �� � �{�{� W�W� �'�'�)����.�.�0��&�&�w�~�/?�'@�Ar) c �~ �� �j dk( r-d�_ �j j �j � y y )Nr� �WAITING)rP r� �
chainDeferred�_finishedRequest)r
r5 s �r* �cbRequestWrittenz6HTTP11ClientProtocol.request.<locals>.cbRequestWritten� s5 �� ��{�{�n�,� '�� ��&�&�4�4�T�5J�5J�K� -r) c � �� �j dk( rPd�_ �j j � �j j t t
| g� � � y �j j d| �j �� y )Nr� �GENERATION_FAILEDzJError writing request, but not in valid state to finalize request: {state})rV rg ) rP r� r� r� r� r r? r� rV )r r5 s �r* �ebRequestWritingz6HTTP11ClientProtocol.request.<locals>.ebRequestWriting sm �� ��{�{�n�,� 1�� ����.�.�0��%�%�-�-�g�6M�s�e�6T�.U�V�� � �!�!�3� � �+�+� "� r) )rP r rQ r r7 r� r r� �_currentRequestr� �_transportProxyr� �_finishResponse�_parserrg r� r )r5 r� r� r� r� r� s ` @r* r� z HTTP11ClientProtocol.request� s� �� �& �;�;�+� %���(�)� )�$�� �(�� � �$�.�.�I�� B� !)� � 7�� � '�� � 5�d�n�n� E�� �'���1E�1E�F�� � � � �#�#�D�$8�$8�9�!%� � �!?�!?�� � L�
� �%�%�&6�8H�I��$�$�$r) c � � y)a!
Called by an L{HTTPClientParser} to indicate that it has parsed a
complete response.
@param rest: A C{bytes} giving any trailing bytes which were given to
the L{HTTPClientParser} which were not part of the response it
was parsing.
Nr( r� s r* r� z$HTTP11ClientProtocol._finishResponse r� r) �finishResponsec � � | j dk( rd| _ n,d| _ | j j | j � | j �y t d� }| j j j dd� }d|v s%| j dk7 s| j j s| j t |� � y | j j � | j | � | j' |� y # t $ r8 | j j# d� | j j% � Y �Rw xY w) Nr� r� r� z
synthetic!ra r( s closer� )rP r� r� r� r� r rf r� r� r� �_giveUpr r� ri r� rT r� rV r� r� )r5 r� r6 rf s r* �_finishResponse_WAITINGz,HTTP11ClientProtocol._finishResponse_WAITING s
� � �;�;�)� #�%�D�K� B�D�K� � "� "� 0� 0��1F�1F� G�
�<�<� � � � �-���l�l�.�.�<�<�]�B�O� �
��
$��{�{�k�)��'�'�2�2� �L�L��� � )�
�N�N� *� *� ,�
0��'�'��-�
� "� "�6� *�� !�
0� � � �!�!�"�%����-�-�/�
0�s �!D �>E�Ec �� � | j �[| j }d| _ d| _ d| _ d| _ | j j � d| _ |j
|� yy)z�
If there is still a parser, call its C{connectionLost} method with the
given reason. If there is not, do nothing.
@type reason: L{Failure}
N)r� r� r� r� r� r� r� )r5 r6 �parsers r* r� z&HTTP11ClientProtocol._disconnectParserL se � � �<�<� #��\�\�F� �D�L�#'�D� �$(�D� !�%)�D� "�
� � � -� -� /�#'�D� � � !� !�&� )� $r) c �Z � | j j � | j |� y)z�
Lose the underlying connection and disconnect the parser with the given
L{Failure}.
Use this method instead of calling the transport's loseConnection
method directly otherwise random things will break.
N)r� r� r� r� s r* r� z HTTP11ClientProtocol._giveUpb s" � �
���%�%�'� � � �v�&r) c � � | j j |� y# t $ r | j t � � Y yw xY w)z4
Handle some stuff from some place.
N)r� r� rT r� r rJ s r* r� z!HTTP11ClientProtocol.dataReceivedm s6 � � $� �L�L� %� %�e� ,�� � $� �L�L��� #� $�s � �"A�Ac � � y)zh
The underlying transport went away. If appropriate, notify the parser
object.
Nr( r� s r* r� z#HTTP11ClientProtocol.connectionLostv r� r) r� c � � d| _ y)z{
Nothing is currently happening. Move to the C{'CONNECTION_LOST'}
state but otherwise do nothing.
�CONNECTION_LOSTNr� r� s r* �_connectionLost_QUIESCENTz.HTTP11ClientProtocol._connectionLost_QUIESCENT~ � � �
(�� r) c � � d| _ y)z�
The connection was in an inconsistent state. Move to the
C{'CONNECTION_LOST'} state but otherwise do nothing.
r� Nr� r� s r* �!_connectionLost_GENERATION_FAILEDz6HTTP11ClientProtocol._connectionLost_GENERATION_FAILED� r� r) c � � d| _ | j j t t |g� � � | `| j
j
� y)z�
Fail the L{Deferred} for the current request, notify the request
object that it does not need to continue transmitting itself, and
move to the C{'CONNECTION_LOST'} state.
r� N)rP r� r� r rB r� r: r� s r* � _connectionLost_TRANSMITTINGz1HTTP11ClientProtocol._connectionLost_TRANSMITTING� sF � � (�� � � � �%�%�g�.G���.Q�&R�S� � !�
� � �(�(�*r) c � � d| _ y)z9
Move to the C{'CONNECTION_LOST'} state.
r� Nr� r� s r* �5_connectionLost_TRANSMITTING_AFTER_RECEIVING_RESPONSEzJHTTP11ClientProtocol._connectionLost_TRANSMITTING_AFTER_RECEIVING_RESPONSE� s � � (�� r) c �4 � | j |� d| _ y)a
Disconnect the response parser so that it can propagate the event as
necessary (for example, to call an application protocol's
C{connectionLost} method, or to fail a request L{Deferred}) and move
to the C{'CONNECTION_LOST'} state.
r� N)r� rP r� s r* �_connectionLost_WAITINGz,HTTP11ClientProtocol._connectionLost_WAITING� s � �
� � �v�&�'�� r) c � � | j t t � � � d| _ | j D ] }|j d� � g | _ y)z�
Disconnect the response parser with a L{ConnectionAborted} failure, and
move to the C{'CONNECTION_LOST'} state.
r� N)r� r rD rP r� r� )r5 r6 r s r* �_connectionLost_ABORTINGz-HTTP11ClientProtocol._connectionLost_ABORTING� sK � �
� � �w�'8�':� ;�<�'�� ��%�%� �A�
�J�J�t� � � !�� r) c �� � | j dk( r t d� S | j j � d| _ t � }| j
j
|� |S )zw
Close the connection and cause all outstanding L{request} L{Deferred}s
to fire with an error.
r� N�ABORTING)rP r r� r� r r� r| )r5 r s r* �abortzHTTP11ClientProtocol.abort� sR � �
�;�;�+� +��4�=� � ���%�%�'� �� � �J�� � � �#�#�A�&��r) ) r$ r% r& r' rP r� r� r� r� r� r
r� r3 r< rg r� r� rV r� � _finishResponse_TRANSMITTINGr� r� r� r� r� r� r� r� r� r� r� r( r) r* r� r� � s� � �;�z �F��G����O��O� �� �8�D�)7� "� �� ��A%�F � -�-=��O�O�++�Z $;� �*�, '�$� � ,�,<�n�M�N�(�(� +�(� (� "� r) r� )Or' �re�zope.interfacer �twisted.internet.deferr r r r r �twisted.internet.errorr �twisted.internet.interfacesr
r �twisted.internet.protocolr �twisted.loggerr
�twisted.protocols.basicr �twisted.python.compatr �twisted.python.componentsr �twisted.python.failurer �twisted.python.reflectr �twisted.web.httpr r r r r r �twisted.web.http_headersr �twisted.web.iwebr r r r r r r rU r2 r" r- r/ r9 r; r? rB rD rF rI rK rO rQ rX rZ r� �compilerK rw r� r� r� r� r� r/ rV r^ r� r r� r� r( r) r* �<module>r� s. ��
�0
� &�� � 2� @� .� !� 0� /� 7� *� 5�� � -� F� F�
�� ��
��
��
�X�
��� � �)� � �� ��� � � � � � /� �� 1� �� � � �i� ��9� �!�&� !�"�N� � �Y� �
� M$� � M$�`^'�z� ^'�B ��
�
��
�� � �
�
����
�:3�. �R�Z�Z�,�
-�
�-�.
�^� �j:� j:� �j:�Z D?� D?�N�> (��7� �
�Y��rU� rU� �rU�j
�Y��)"� )"� �)"�X
�]��:,� :,� �:,�z�8� r)